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com.ibm.speech.net.www.protocol.https 

Class HttpsURLConnection 

j ava . lang . Ob j ect 

+ -- j ava . net . URLConnection 
I 

+ — j ava . net . HttpURLConnection 
I 

+— com . ibm . speech . net . www . protocol . https . HttpsURLConnection 



FRAMES NO FRAMES 

DETAIL: FIELD i CONSTR I METHOD 



public class HttpsURLConnection 

extends java.net. HttpURLConnection 



, 'R The class HttpsURLConnection represents a communications link between the application and a 
in URL. Instances of this class can be used both to read from and to write to the resource referenced by 
!s the URL. In general, creating a connection to a URL is a multistep process: 



openConnection ( ) 


connect ( ) 


Manipulate parameters that affect the connection to the 
remote resource. 


Interact with the resource; query header 
fields and contents. 



> 



time 

1 . The connection object is created by invoking the openConnection method on a URL. 

2. The setup parameters and general request properties are manipulated. 

3. The actual connection to the remote object is made, using the connect method. 

4. The remote object becomes available. The header fields and the contents of the remote object 
can be accessed. 



The setup parameters are modified using the following methods: 



• set AllowUser Inter act ion 

• setDoInput 

• setDoOutput 

• set If Modi f iedSince 

• setUseCaches 

and the general request properties are modified using the method: 



• set Request Property 

Default values for the AiiowUserinteraction and UseCaches parameters can be set using the 

methods setDef aultAllowUserlnteraction and setDef aultUseCaches. Default values for 
general request properties can be set using the setDef auitRequestProperty method. 
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Each of the above set methods has a corresponding get method to retrieve the value of the 
parameter or general request property. The specific parameters and general request properties that are 
applicable are protocol specific. 

The following methods are used to access the header fields and the contents after the connection is 
made to the remote object: 

• getContent 

• getHeaderField 

• getlnputStream 

• getOutputStream 

Certain header fields are accessed frequently. The methods: 

• getContentEncoding 

• getContentLength 

• getContentType 

• getDate 

• getExpiration 

• getLastModif ed 

: n 

ifi provide convenient access to these fields. The getContentType method is used by the getContent 
! : D method to determine the type of the remote object; subclasses may find it convenient to override the 

ijl getContentType method. 

:p In the common case, all of the pre-connection parameters and general request properties can be 

I J ignored: the pre-connection parameters and request properties default to sensible values. For most 
clients of this interface, there are only two interesting methods: get inputstream and getob j ect, 

□ which are mirrored in the url class by convenience methods. 

M HttpsURLConnection is a URLConnection with support for HTTPS-specific features. See the spec 

; : Q for details. 



Field Summary 


static int 


HTTP ACCEPTED 


static int 


HTTP BAD GATEWAY 


static int 


HTTP BAD METHOD 


static int 


HTTP BAD REQUEST 

4XX: client error 


static int 


HTTP CLIENT TIMEOUT 


static int 


HTTP CONFLICT 


static int 


HTTP CREATED 
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static int 



HTTP FORBIDDEN 



static int 



HTTP GATEWAY TIMEOUT 



static int 



HTTP GONE 



static int 



HTTP INTERNAL ERROR 



static int 



HTTP LENGTH REQUIRED 



static int 



HTTP MOVED PERM 



static int 



HTTP MOVED TEMP 



static int 



HTTP MULT CHOICE 



3 XX: relocation/redirect 



static int 



HTTP NO CONTENT 



static int 



HTTP NOT ACCEPTABLE 



static int 



HTTP NOT AUTHORITATIVE 



static int 



HTTP NOT FOUND 



static int 



HTTP NOT MODIFIED 



static int 



HTTP OK 



2XX: generally "OK" 



static int 



HTTP PARTIAL 



static int 



HTTP PAYMENT REQUIRED 



static int 



HTTP PRECON FAILED 



static int 



HTTP PROXY AUTH 



static int 



HTTP REQ TOO LONG 



static int 



HTTP RESET 



static int 



HTTP SEE OTHER 
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static int 



HTTP SERVER ER55R 




5XX: server error 



static int 



HTTP UNAUTHORIZED 



static int 



HTTP UNAVAILABLE 



static int 



HTTP UNSUPPORTED TYPE 



static int 



HTTP USE PROXY 



static int 



HTTP VERSION 



Fields inherited from class java.net.HttpURLConnection 



HTTP_ACCEPTED, HTTP_BAD_GATEWAY, HTTP_BAD_METHOD, HTTP_BAD_REQUEST, 
HTTP_CLIENT__TIMEOUT, HTTP_CONFLICT, HTTP_CREATED, HTTP_ENTITY_TOO_LARGE , 
HTTP_FORBIDDEN, HTT P_G ATE WA Y_T I MEOUT , HTTP_GONE, HTTP_INTERNAL_ERROR, 
HTTP_LENGTH_REQUIRED, HTTP_MOVED_PERM, HTT P_MO VE D_T EM P , HTTP_MULT_CHOICE, 
HTTP_NO_CONTENT, HTTP_NOT_ACCEPTABLE, HTTP_NOT_AUTHORITATIVE , HTTP_NOT_FOUND / 
HTTP_NOT_MODIFIED, HTTP_OK, H T T P__ PART I AL , HTTP_PAYMENT_REQUIRED, 
HTTP_PRECON_FAILED, HTTP_PROXY_AUTH, HTTP_REQ_TOO_LONG, HTTP_RESET, 
HTTP_SEE_OTHER, HTT P_S ERVER_ERROR , HTTP__UNAUTHORI ZED, HTT P_U N A V A I L AB L E , 
HTTP_UNSUPPORTED__TYPE, HTTP__USE_PROXY, HTTP_VERSION, method, responseCocie , 
responseMessage 



Fields inherited from class java.netURLConnection 

allowUserlnteraction, connected, dolnput, doOutput, ifModif iedSince , url, 
useCaches 



Constructor Summary 

HttpsURLConnection ( j ava . net . URL u) 

Creates a new HttpsURLConnection instance to the object referenced by the url argument 
with the default debug flag. 

HttpsURLConnection ( j ava . net . URL u, boolean dbg) 

Creates a new HttpsURLConnection instance to the object referenced by the url argument 
with a specified debug flag. 



Method Summary 


void 


connect ( ) 

Opens a communications link to the resource referenced by this 
URL, if such a connection has not already been established. 


void 


disconnect (•) 

Close the connection to the server. 


boolean 


getAllowUser Interaction ( ) 

Returns the value of the allowUserlnteraction field for this 
object. 
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java. lang. String 


ge^C on t en tEn coding ( ) 

Returns the value of the content-encoding header field. 


int 


getContentLength ( ) 

Returns the value of the content-length header field. 


java . lang. String 


getC on tent Type ( ) 

Returns the value of the content-type header field. 


long 


getDate { ) 

Returns the value of the date header field. 


static boolean 


getDef aultAllowUser Inter action ( ) 

Returns the default value of the aiiowUserinteraction field. 


static java . lang . String 


getDef aultRe que st Property (java . lang . String key) 
Returns the value of the default request property. 


boolean 


getDef aultUseC aches ( ) 

Returns the default value of a URLConnection's useCaches flag. 


boolean 


getDoInput ( ) 

Returns the value of this URLConnection's dolnput flag. 


boolean 


getDoOutput ( ) 

Returns the value of this URLConnection's doOutput flag. 


j ava . io . InputStream 


getErr or Stream ( ) 

Returns the error stream if the connection failed but the server sent 
useful data nonetheless. 


long 


getExpiration ( ) 

Returns the value of the expires header field. 


static java. net . FileNameMap 


get FileNameMap ( ) 

Returns the FileNameMap. 


static boolean 


getFollowRedirects ( ) 


java . lang . String 


getHeaderField (int n ) 

Returns the value for the n** 1 header field. 


java . lang . String 


getHeaderField ( j ava . lang . String name ) 

Returns the name of the specified header field. 


long 


getHeaderFieldDate ( java. lang. String name, long Default) 

Returns the value of the named field parsed as date. 


int 


getHeaderFieldlnt ( java. lang. String name, int Default) 
Returns the value of the named field parsed as a number. 


java . lang . String 


getHeaderFieldKey (int n ) 

Returns the key for the n header field. 


j ava . lang . String 


getHTTPHeader ( ) 

Returns the entire of the HTTP header received from server 
request. 


long 


getlfModif iedSince ( ) 

Returns the value of this object's ifModif iedSince field. 


j ava . io . InputStream 


getlnputStream ( ) 

Returns an input stream that reads from this open connection. 
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long 


g^KastModif ied ( ) 

Returns the value of the last-modified header field. 


java . io . OutputStream 


getOutputStream ( ) 

Returns an output stream that writes to this connection. 


java . security. Permission 


getPennission ( ) 

Returns a permission object representing the permission necessary 
to make the connection represented by this object. 


java . lang . String 


getRequestMethod ( ) 

Get the request method. 


java . lang , String 


getRequestProperty ( j ava . lang . Strinq key) 

Returns the value of the named general request property for this 
connection. 


int 


getResponseCode ( ) 

Gets HTTP response status. 


java . lang . String 


getResponseMessage ( ) 

Gets the HTTP response message, if any, returned along with the 
response code from a server. 


java . net . URL 


getURL ( ) 

Returns the value of this uRLConnection's url field. 


boolean 


getUseCaches ( ) 

Returns the value of this URLConnection's useCaches field. 


protected 
static java . lang. String 


guessContentTypeFromName ( j ava . lang . String f name ) 

Tries to determine the content type of an object, based on the 
specified "file" component of a URL. 


static java . lang. String 


guessContentTypeFromStream ( java . io. InputStream is) 

Tries to determine the type of an input stream based on the 
characters at the beginning of the input stream. 


void 


setAllowUserlnteraction (boolean allowuserinteraction) 
Set the value of the allowuserinteraction field of this 

URLConnection. 


void 


setAsynConnections (boolean value) 

Sets the value of the asyncConnectionSet field for the 
HttpsURLConnection object to the specified value. 


static void 


setContentHandlerFactory 

( j ava . net . Content Handler Factory f ac) 

Sets the ContentHandlerFactory of an application. 


static void 


setDef aultAllowUser Interaction 

(boolean de fault allowuser inter act ion) 

Sets the default value of the allowuserinteraction field for all 
future URLConnection objects to the specified value. 


static void 


setDef aultReouest Proper ty (i ava . lanq . Strinq key, 
java . lang . String value) 

Sets the default value of a general request property. 


void 


setDef aultUseCaches (boolean def aultusecaches ) 

Sets the default value of the useCaches field to the specified 

value. 
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void 


sR5o Input (boolean doinput) 

Sets the value of the doinput field for this URLConnection to the 
specified value. 


void 


setDoOutput (boolean dooutput) 

Sets the value of the doOutput field for this URLConnection to the 
specified value. 


void 


setEnableCipherSuites ( j ava . lang . String cipherSuites ) 

Sets the value of the enabledCipherSuites field for the 
HttpsURLConnection object to the specified value. 


void 


setEnabledCompressionMethods ( j ava . lang . String methods ) 

Sets the value of the enabledCompressionMethods field for the 
HttpsURLConnection object to the specified value. 


static void 


setFileNameMap ( java . net . FileNameMap map) 
Sets the FileNameMap. 


static void 


setFollowRedirects (boolean set) 

Sets whether HTTP redirects (requests with response code 3xx) 
should be automatically followed by this class. 


void 


setlfModif iedSince (long ifmodif iedsince ) 

Sets the value of the ifModif iedsince field of this 
URLConnection to the specified value. 


void 


setKeyRingDatabase ( j ava . lang . String name ) 

Sets the value of the keyRingDatabase field for the 
HttpsURLConnection object to the specified value. 


void 


setRequestMethod ( j ava . lang . String method) 

Set the method for the URL request, one of: GET POST HEAD 
OPTIONS PUT DELETE TRACE are legal, subject to protocol 
restrictions. 


void 


setRequestProperty ( i ava . lanq . Str inq key, 
java . lang . String value) 

Sets the general request property. 


void 


setTimeout ( int seconds ) 

Sets the value of the timeout field for the HttpsURLConnection 
object to the specified value. 


void 


setUseCaches (boolean usecaches) 

Sets the value of the useCaches field of this URLConnection to 
the specified value. 


j ava . lang . String 


toString ( ) 

Returns a string representation of this URL connection. 


boolean 


usingProxy ( ) 

Indicates if the connection is going through a proxy. 




Methods inherited from class java.net.URLConnection 


getContent 




Methods inherited from class java.lang.Object 


clone, equals, finalize, getClass, hashCocle, notify, notifyAll, wait, wait, wait 
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Field Detail 

HTTP OK 

public static final int HTTP_OK 
2XX: generally "OK" 

HTTP_CREATED 

public static final int HTTP_CREATED 

HTTP_ACCEPTED 

public static final int HTTP_ACCEPTED 

HTTP_NOT_AUTHORITATIVE 

public static final int HTTP_NOT_AUTHORI TAT IVE 

HTTP_NO_CONTENT 

public static final int HTTP_NO_CONTENT 

HTTP_RESET 

public static final int HTTP_RESET 

HTTPPARTIAL 

public static final int H T T P_PART I AL 

HTTPJMULTCHOICE 

public static final int HTTP_MULT_CHOICE 

3XX: relocation/redirect 
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HTTP_MOVED_PERM 

public static final int HTTP_MOVED_PERM 

HTTP_MOVED_TEMP 

public static final int HTTP_MOVED_TEMP 

HTTPSEEOTHER 

public static final int HTTP_SEE_OTHER 

HTTP_NOT_MODIFIED 

public static final int HTTP_NOT_MODIFIED 

HTTP_USE_PROXY 

public static final int HTTP_USE_PROXY 

HTTPBADREQUEST 

public static final int HTTP_BAD_REQUEST 

4XX: client error 
HTTPJJNAUTHORIZED 

public static final int HTTP_UNAUTHORI ZED 

HTTPPAYMENTREQUIRED 

public static final int HTTP_PAYMENT_REQUIRED 

HTTP_FORBIDDEN 

public static final int HTTP FORBIDDEN 
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HTTPNOTFOUND 

public static final int HTTP_NOT_FOUND 

HTTP_BAD_METHOD 

public static final int HTTP_BAD_ME THOD 

HTTP_NOT_ACCEPTABLE 

public static final int HTTP_NOT_ACCEPTABLE 

HTTP_PROXY_AUTH 

public static final int HTTP_PROXY_AUTH 

HTTPCLIENTJTIMEOUT 

public static final int HTTP_CLIENT_TIMEOUT 

HTTPCONFLICT 

public static final int HTTP_CONFLICT 

HTTP_GONE 

public static final int HTTP_GONE 

HTTPLENGTHREQUIRED 

public static final int HTTP_LENGTH_REQUIRED 

HTTPPRECONF AILED 

public static final int HTTP_PRECON_FAILED 



HTTPENTITYTOOLARGE 
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public static final int HTTP_ENTITY_TOO_LARGE 

HTTPREQTOOLONG 

public static final int HTTP_REQ_TOO_LONG 

HTTP_UNSUPPORTED_TYPE 

public static final int HTTP_UNSUPPORTED_TYPE 

HTTPSERVERERROR 

' public static final int HTTP_SERVER_ERROR 
5 XX: server error 

HTTP INTE RNALERRO R 

public static final int HTTP_INTERNAL_ERROR 

HTTPBADGATEWAY 

public static final int HTTP_BAD_GATEWAY 

HTTP_UNAVAILABLE 

public static final int HTTP_UNAVAILABLE 

HTTPGATEWAYTIMEOUT 

public static final int HTTP_GATEWAY_TIMEOUT 

HTTP_VERSION 

public static final int HTTP_VERSION 

Constructor Detail 
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HttpsURLConnection 

public HttpsURLConnection ( java . net . URL u) 

Creates a new HttpsURLConnection instance to the object referenced by the url argument 

with the default debug flag. 

Parameters: 

u - the URL that this connects to. 



HttpsURLConnection 

public HttpsURLConnection ( j ava . net . URL u, 

boolean dbg) 

Creates a new HttpsURLConnection instance to the object referenced by the url argument 

with a specified debug flag. 

Parameters: 

u - the URL that this connects to. 

dbg - dbg the boolean value of turning the debug option ON/OFF. 



Method Detail 



getlnputStream 

public java . io. InputSt ream getlnputStream ( ) 

throws java . io . IOException 

Returns an input stream that reads from this open connection. 
Overrides: 

getlnputStream in class java.net.URLConnection 
Returns: 

an input stream that reads from this open connection. 
Throws: 

java.io. IOException - if an I/O error occurs while creating the input stream. 
UnknownServiceException - if the protocol does not support input. 



getOutputStream 

public java. io. Output Stream getOutputStream ( ) 

throws java . io. IOException 

Returns an output stream that writes to this connection. 
Overrides: 

getOutputStream in class java.net.URLConnection 
Returns: 

an output stream that writes to this connection. 
Throws: 

java.io.IOException - if an I/O error occurs while creating the output stream. 
UnknownServiceException - if the protocol does not support output. 
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disconnect 

public void disconnect ( ) 

Close the connection to the server. 
Overrides: 

disconnect in class java.net. HttpURLConnection 



usingProxy 

public boolean usingProxy () 

Indicates if the connection is going through a proxy. 
Overrides: 

usingProxy in class java.net. HttpURLConnection 



connect 

public void connect ( ) 

throws java . io . IOException 

Opens a communications link to the resource referenced by this URL, if such a connection has 
not already been established. 

If the connect method is called when the connection has already been opened (indicated by the 
connected field having the value true), the call is ignored. 

HttpsURLConnection objects go through two phases: first they are created, then they are 
connected. After being created, and before being connected, various options can be specified 
(e.g., dolnput and UseCaches). After connecting, it is an error to try to set them. Operations 
that depend on being connected, like getContentLength, will implicitly perform the connection, 
if necessary. 

Overrides: 

connect in class java.net. URLConnection 
Throws: 

java.io. IOException - if an I/O error occurs while opening the connection. 



setRequestMethod 

public void setRequestMethod ( j ava . lang . String method) 

throws java . net . ProtocolException 

Set the method for the URL request, one of: 

• GET 

• POST 

• HEAD 
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• OPTIONS 
« PUT 

• DELETE 

• TRACE 

are legal, subject to protocol restrictions. The default method is GET. 
Overrides: 

setRequestMethod in class java.net. HttpURLConnection 
Throws: 

java.net.ProtocolException - if the method cannot be reset or if the requested method 
isn't valid for HTTP. 



setRequestProperty 

public void setRequestProperty ( j ava . lang . String key, 

j ava . lang . String value) 

Sets the general request property. 
Overrides: 

setRequestProperty in class java.net.URLConnection 
Parameters: 

key - the keyword by which the request is known (e.g., "accept"), 
value - the value associated with it. 



getHeaderField 

public j ava . lang . String getHeaderField ( j ava . lang . String name) 

Returns the name of the specified header field. 
Overrides: 

getHeaderField in class java.net.URLConnection 
Parameters: 

name - the name of a header field. 
Returns: 

the value of the named header field, or null if there is no such field in the header. 



getHTTPHeader 

public j ava . lang. String getHTTPHeader ( ) 

Returns the entire of the HTTP header received from server request. 
Returns: 

the value of the httpHeader field for this object. 



getAllowUserlnteraction 

public boolean getAllowUserlnteraction ( ) 

Returns the value of the aiiowuserinteraction field for this object. 
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Overrides: 

getAllowUserlnteraction in class java.net.URLConnection 
Returns: 

the value of the aiiowuserinteraction field for this object. 



getContentEncoding 

public java . lang . String getContentEncoding ( ) 

Returns the value of the content-encoding header field. 
Overrides: 

getContentEncoding in class java.net.URLConnection 
Returns: 

the content encoding of the resource that the URL references, or null if not known. 



getContentLength 

public int getContentLength ( ) 

Returns the value of the content-length header field. 
Overrides: 

getContentLength in class java.net.URLConnection 
Returns: 

the content length of the resource that this connection's URL references, or -1 if the 
content length is not known. 



getContentType 

public java . lang . String getContentType ( ) 

Returns the value of the content-type header field. 
Overrides: 

getContentType in class java.net.URLConnection 
Returns: 

the content type of the resource that the URL references, or null if not known. 



getDate 

public long getDate ( ) 

Returns the value of the date header field. 
Overrides: 

getDate in class java.net.URLConnection 
Returns: 

the sending date of the resource that the URL references, or 0 if not known. The value 
returned is the number of milliseconds since January 1, 1970 GMT. 
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getDefaultAllowUserlnteraction 

public static boolean getDef aultAllowUser Interact! on ( ) 

Returns the default value of the aiiowuserinteraction field. 

Ths default is "sticky", being a part of the static state of all URLConnections. This flag applies 
to the next, and all following URLConnections that are created. 

Returns: 

the default value of the allowUserlnteraction field. 



getDefaultRequestProperty 

public static java . lang . String getDef aultRe quest Property (j ava . la ng . String key) 

Returns the value of the default request property. Default request properties are set for every 

connection. 

Returns: 

the value of the default request property for the specified key. 



getDefaultUseCaches 

public boolean getDefaultUseCaches ( ) 

Returns the default value of a URLConnections useCaches flag. 

Ths default is "sticky", being a part of the static state of all URLConnections. This flag applies 
to the next, and all following URLConnections that are created. 

Overrides: 

getDefaultUseCaches in class java.net.URLConnection 
Returns: 

the default value of a URLConnect ion's useCaches flag. 



getDoInput 

public boolean getDoInput () 

Returns the value of this URLConnections dolnput flag. 
Overrides: 

getDoInput in class java.net.URLConnection 
Returns: 

the value of this URLConnections dolnput flag. 



getDoOutput 
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public boolean getDoOutput ( ) 

Returns the value of this URLConnect ion's doOutput flag. 
Overrides: 

getDoOutput in class java.net.URLConnection 
Returns: 

the value Of this URLConnectionS doOutput flag. 



getExpiration 

public long getExpiration ( ) 

Returns the value of the expires header field. 
Overrides: 

getExpiration in class java.net.URLConnection 
Returns: 

the expiration date of the resource that this URL references, or 0 if not known. The value 
is the number of milliseconds since January 1, 1970 GMT. 



getFileNameMap 

public static j ava . net . FileNameMap getFileNameMap ( ) 

Returns the FileNameMap. 
Since: 

JDK1.2 



getHeaderField 

public j ava . lang . String getHeaderField ( int n) 

Returns the value for the n th header field. It returns null if there are fewer than n fields. 

This method can be used in conjunction with the getHeaderFieidKey method to iterate 
through all the headers in the message. 

Overrides: 

getHeaderField in class java.net.URLConnection 
Parameters: 

n - an index. 
Returns: 

the value of the n th header field. 



getHeaderFieldDate 

public long getHeaderFieldDate ( j ava . lang . String name, 
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long Default) 

Returns the value of the named field parsed as date. The result is the number of milliseconds 
since January 1, 1970 GMT represented by the named field. 

This form of getHeaderField exists because some connection types (e.g., http-ng) have pre- 
parsed headers. Classes for that connection type can override this method and short-circuit the 
parsing. 

Overrides: 

getHeaderFieldDate in class java.net.URLConnection 
Parameters: 

name - the name of the header field. 

Default - a default value. 
Returns: 

the value of the field, parsed as a date. The value of the Default argument is returned if 
the field is missing or malformed. 



getHeaderFieldlnt 

public int getHeaderFieldlnt ( j ava . lang . String name, 

int Default) 

Returns the value of the named field parsed as a number. 

This form of getHeaderField exists because some connection types (e.g., http-ng) have pre- 
parsed headers. Classes for that connection type can override this method and short-circuit the 
parsing. 

Overrides: 

getHeaderFieldlnt in class java.net.URLConnection 
Parameters: 

name - the name of the header field. 

Default - the default value. 
Returns: 

the value of the named field, parsed as an integer. The Default value is returned if the 
field is missing or malformed. 



getHeaderFieldKey 

public j ava . lang . String getHeaderFieldKey (int n) 

Returns the key for the n th header field. 
Overrides: 

getHeaderFieldKey in class java.net.URLConnection 
Parameters: 

n - an index. 
Returns: 

the key for the n th header field, or null if there are fewer than n fields. 
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getlfModifiedSince 

public long getlfModif iedSince ( ) 

Returns the value of this object's ifModif iedSince field. 
Overrides: 

getlfModifiedSince in class java.net.URLConnection 
Returns: 

the value of this object's ifModif iedSince field. 



getLastModified 

public long getLastModified ( ) 

Returns the value of the last-modified header field. The result is the number of milliseconds 

since January 1, 1970 GMT. 

Overrides: 

getLastModified in class java.net.URLConnection 
Returns: 

the date the resource referenced by this URLConnection was last modified, or 0 if not 
known. 



getPermission 

public j ava . security . Permission getPermission { ) 

throws j ava . io . IOException 

Returns a permission object representing the permission necessary to make the connection 
represented by this object. This method returns null if no permission is required to make the 
connection. By default, this method returns j ava. security. AiiPermission. Subclasses 
should override this method and return the permission that best represents the permission 
required to make a a connection to the URL. For example, a URLConnection representing a 

file : URL would return a j ava . io . FilePermission object. 

The permission returned may dependent upon the state of the connection. For example, the 
permission before connecting may be different from that after connecting. For example, an 
HTTP sever, say foo.com, may redirect the connection to a different host, say bar.com. Before 
connecting the permission returned by the connection will represent the permission needed to 
connect to foo.com, while the permission returned after connecting will be to bar.com. 

Permissions are generally used for two purposes: to protect caches of objects obtained through 
URLConnections, and to check the right of a recipient to learn about a particular URL. In the 
first case, the permission should be obtained after the object has been obtained. For example, in 
an HTTP connection, this will represent the permission to connect to the host from which the 
data was ultimately fetched. In the second case, the permission should be obtained and tested 
before connecting. 

Overrides: 

getPermission in class java.net.HttpURLConnection 
Returns: 
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the permission o representing the permission necessa^^ make the connection 
represented by this URLConnection. 
Throws: 

java.io.IOException - if the computation of the permission requires network or file I/O 
and an exception occurs while computing it. 



getRequestProperty 

public java . lang . String getRequestProperty ( j ava . lang . String key) 

Returns the value of the named general request property for this connection. 
Overrides: 

getRequestProperty in class java.net. URLConnection 
Returns: 

the value of the named general request property for this connection. 



getURL 

public java. net. URL getURL ( ) 

Returns the value of this URLConnection's url field. 
Overrides: 

getURL in class java.net.URLConnection 
Returns: 

the value of this URLConnection's URL field. 



getUseCaches 

public boolean getUseCaches ( ) 

Returns the value of this URLConnection's useCaches field. 
Overrides: 

getUseCaches in class java.net.URLConnection 
Returns: 

the value of this URLConnection's useCaches field. 



guessContentTypeFromName 

protected static j ava . lang . String guessContentTypeFromName ( j ava . lang . String fname) 

Tries to determine the content type of an object, based on the specified "file" component of a 
URL. This is a convenience method that can be used by subclasses that override the 
getContentType method. 

Parameters: 

fname - a filename. 
Returns: 

a guess as to what the content type of the object is, based upon its file name. 
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guessContentTypeFromStream 

public static java . lang . String guessContentTypeFromStream (java . io . Input St ream is) 

throws java . io . IOException 

Tries to determine the type of an input stream based on the characters at the beginning of the 
input stream. This method can be used by subclasses that override the getContentType 
method. 

Ideally, this routine would not be needed. But many http servers return the incorrect content 
type; in addition, there are many nonstandard extensions. Direct inspection of the bytes to 
determine the content type is often more accurate than believing the content type claimed by 
the http server. 

Parameters: 

is - an input stream that supports marks. 
Returns: 

a guess at the content type, or null if none can be determined. 
Throws: 

java.io.IOException - if an I/O error occurs while reading the input stream. 



setAllowUserlnteraction 

public void setAllowUserlnteraction (boolean allowuserinteraction) 
Set the value of the allowuserinteraction field of this URLConnection. 

Overrides: 

setAllowUserlnteraction in class java.net.URLConnecti on 
Parameters: 

allowuserinteraction - the new value. 



setContentHandlerFactory 

public static void setContentHandlerFactory ( j ava . net . ContentHandlerFactory fac) 

Sets the ContentHandlerFactory of an application. It can be called at most once by an 
application. 

The ContentHandlerFactory instance is used to construct a content handler from a content 
type 

If there is a security manager, this method first calls the security managers checkSetFactory 
method to ensure the operation is allowed. This could result in a SecurityException. 

Parameters: 

fac - the desired factory. 
Throws: 

java.lang.Error - if the factory has already been defined. 

java.lang.SecurityException - if a security manager exists and its checkSetFactory 
method doesn't allow the operation. 
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setDefauItAllowUserlnteraction 

public static void setDefauItAllowUserlnteraction (boolean def aultallowuserinteracti 

Sets the default value of the allowUserlnteraction field for all future URLConnection 

objects to the specified value. 

Parameters: 

def aultallowuserinteraction - the new value. 



setDefaultRequestProperty 

public static void setDef aultRe quest Property ( j ava . lang . String key, 

java . lang. String value) 

Sets the default value of a general request property. When a URLConnection is created, it is 

initialized with these properties. 

Parameters: 

key - the keyword by which the request is known (e.g., "accept"), 
value - the value associated with the key. 



setDefaultUseCaches 

public void setDef aultUseCaches (boolean def aultusecaches) 

Sets the default value of the useCaches field to the specified value. 
Overrides: 

setDefaultUseCaches in class java.net.URLConnection 
Parameters: 

def aultusecaches - the new value. 



setDoInput 

public void setDoInput (boolean doinput) 

Sets the value of the doinput field for this URLConnection to the specified value. 

A URL connection can be used for input and/or output. Set the Doinput flag to true if you 
intend to use the URL connection for input, false if not. The default is true unless DoOutput is 
explicitly set to true, in which case Doinput defaults to false. 

Overrides: 

setDoInput in class java.net.URLConnection 
Parameters: 

value - the new value. 
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setDoOutput 

public void setDoOutput {boolean dooutput) 

Sets the value of the doOutput field for this URLConnection to the specified value. 

A URL connection can be used for input and/or output. Set the DoOutput flag to true if you 
intend to use the URL connection for output, false if not. The default is false. 

Overrides: 

setDoOutput in class java.net.URLConnection 
Parameters: 

value - the new value. 



setFileNameMap 

public static void setFileNameMap { j ava . net . FileNameMap map) 
Sets the FileNameMap. 

If there is a security manager, this method first calls the security manager's checkSetFactory 
method to ensure the operation is allowed. This could result in a SecurityException. 

Parameters: 

map - the FileNameMap to be set 
Throws: 

j ava. lang. SecurityException - if a security manager exists and its checkSetFactory 
method doesn't allow the operation. 



setlfModifiedSince 

public void setlfModif iedSince ( long ifmodif iedsince ) 

Sets the value of the ifModif iedsince field of this URLConnection to the specified value. 
Overrides: 

setlfModifiedSince in class java.net.URLConnection 
Parameters: 

value - the new value. 



setUseCaches 

public void setUseCaches (boolean usecaches) 

Sets the value of the useCaches field of this URLConnection to the specified value. 

Some protocols do caching of documents. Occasionally, it is important to be able to "tunnel 
through" and ignore the caches (e.g., the "reload" button in a browser). If the UseCaches flag 
on a connection is true, the connection is allowed to use whatever caches it can. If false, caches 
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are to be ignored. Th^fcult value comes from DefaultUseC^fe, which defaults to true. 
Overrides: 

setUseCaches in class java.net.URLConnection 

toString 

public java . lang. String toString () 

Returns a string representation of this URL connection. 
Overrides: 

toString in class java.net.URLConnection 
Returns: 

a string representation of this URLConnection. 
getErrorStream 

public java . io . Input St ream getErrorStream ( ) 

Returns the error stream if the connection failed but the server sent useful data nonetheless. 
The typical example is when an HTTP server responds with a 404, which will cause a 
FileNotFoundException to be thrown in connect, but the server sent an HTML help page with 
suggestions as to what to do. 

This method will not cause a connection to be initiated. If there the connection was not 
connected, or if the server did not have an error while connecting or if the server did have an 
error but there no error data was sent, this method will return null. This is the default. 

Overrides: 

getErrorStream in class java.net. HttpURLConnection 
Returns: 

an error stream if any, null if there have been no errors, the connection is not connected 
or the server sent no useful data. 



getFollowRedirects 

public static boolean getFollowRedirects { ) 

getRequestMethod 

public java . lang. String getRequestMethod ( ) 

Get the request method. 
Overrides: 

getRequestMethod in class java.net. HttpURLConnection 
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getResponseCode 

public int getResponseCode ( ) 

throws java.io.IOException 

Gets HTTP response status. From responses like: 

HTTP/1.0 200 OK 

HTTP/1.0 401 Unauthorized 



Extracts the ints 200 and 401 respectively. Returns -1 if none can be discerned from the 

response (i.e., the response is not valid HTTP). 

Overrides: 

getResponseCode in class java.net.HttpURLConnecti on 
Throws: 

java.io.IOException - if an error occurred connecting to the server. 



getResponseMessage 

public j ava . lang . String getResponseMessage ( ) 

throws java.io.IOException 

Gets the HTTP response message, if any, returned along with the response code from a server. 
From responses like: 

HTTP/1.0 200 OK 
HTTP/1.0 404 Not Found 



Extracts the Strings "OK" and "Not Found" respectively. Returns null if none could be 

discerned from the responses (the result was not valid HTTP). 

Overrides: 

getResponseMessage in class java.net.HttpURLConnection 
Throws: 

java.io.IOException - if an error occurred connecting to the server. 



setFollowRedirects 

public static void setFollowRedirects (boolean set) 

Sets whether HTTP redirects (requests with response code 3xx) should be automatically 
followed by this class. True by default. Applets cannot change this variable. 

If there is a security manager, this method first calls the security manager's checkSetFactory 
method to ensure the operation is allowed. This could result in a SecurityException. 

Throws: 

java.lang.SecurityException - if a security manager exists and its checkSetFactory 
method doesn't allow the operation. 
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setKeyRingDatabase 

public void setKeyRingDatabase (java . Ian g. String name) 

Sets the value of the keyRingDatabase field for the HttpsURLConnection object to the 

specified value. SSL specific API extension. 

Parameters: 

name - the new value. 



setTimeout 

public void setTimeout ( int seconds) 

Sets the value of the timeout field for the HttpsURLConnection object to the specified value. 

SSL specific API extension. 

Parameters: 

seconds - the new value. 



setAsynConnections 

public void setAsynConnections (boolean value) 

Sets the value of the asyncConnectionSet field for the HttpsURLConnection object to the 

specified value. SSL specific API extension. 

Parameters: 

value - the new value. 



setEnabledCompressionMethods 

public void setEnabledCompressionMethods ( j ava . lang . String methods) 
j Sets the value of the enabledCompressionMethods field for the HttpsURLConnection object 

to the specified value. SSL specific API extension. 
Parameters: 

methods - the new value. 



setEnableCipherSuites 

public void setEnableCipherSuites ( j ava . lang . String cipherSuites ) 

Sets the value of the enabiedCipherSuites field for the HttpsURLConnection object to the 

specified value. SSL specific API extension. 

Parameters: 

cipherSuites - the new value. 
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